home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / mail / listserv / doc / listproc.txt.Z / listproc.txt
Encoding:
Internet Message Format  |  1994-11-14  |  53.5 KB
  1. From porath@henson.cc.wwu.edu Tue Sep 13 17:08:38 1994
  2. Return-Path: <porath@henson.cc.wwu.edu>
  3. Received: from henson.cc.wwu.edu by cs.bu.edu (8.6.4/Spike-2.1)
  4.     id RAA18802; Tue, 13 Sep 1994 17:08:31 -0400
  5. Received: by henson.cc.wwu.edu
  6.     (5.65/WWU-H1.2/UW-NDC Revision: 2.26 ) id AA04440; Tue, 13 Sep 1994 14:08:57 -0700
  7. Date: Tue, 13 Sep 1994 14:08:57 -0700
  8. From: Mark Porath <porath@henson.cc.wwu.edu>
  9. Message-Id: <9409132108.AA04440@henson.cc.wwu.edu>
  10. To: tasos@cs.bu.edu
  11. Status: RO
  12.  
  13. 5
  14.  
  15.                               
  16.                               
  17.                               
  18.                               
  19.                               
  20.                               
  21.                               
  22.                               
  23.                               
  24.                               
  25.                               
  26.                 Western Washington University
  27.                               
  28.               Administrative Computing Services
  29.                               
  30.                  ListProcessor version 6.0c
  31.                               
  32.                      Owners Guide Manual
  33.                               
  34.                          April 1994
  35.  
  36.                               
  37.                               
  38.                          Prepared by
  39.                               
  40.                        Mark A. Porath
  41.                               
  42.                               
  43.                               
  44.                               
  45.                               
  46.                             DRAFT
  47.                       Table of Contents
  48.  
  49. Basics of ListProcessor . . . . . . . . . . . . . . . . . .
  50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  51. . . . 4
  52.      What is ListProcessor?  . . . . . . . . . . . . . . . .
  53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  54. . . 4
  55.      What is Electronic Mail . . . . . . . . . . . . . . . .
  56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  57. . . 4
  58.                               What Can You do with
  59. ListProcessor   . . . . . . . . . . . . . . . . . . . . . .
  60. . . . . . . . . . . . . . . 4
  61.                               About This Document  . . . . .
  62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  63. . . . . . . . . . . . . . . 5
  64.  
  65. Using ListProcessor . . . . . . . . . . . . . . . . . . . .
  66. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  67. . . . . 6                     How Does One Use
  68. ListProcessor? . . . . . . . . . . . . . . . . . . . . . . .
  69. . . . . . . . . . . . . . . . . 6
  70.   How Does One Send Mail to ListProcessor? . . . . . . . . .
  71. . . . . . . . . . . . . . . . . . . . . . . . 6
  72.                               How Does One Send Mail to a
  73. List? . . . . . . . . . . . . . . . . . . . . . . . . . . .
  74. . . . . . . . . . . . 7
  75.   How Does One Find Out What Lists Are Available . . . . . .
  76. . . . . . . . . . . . . . . . . . . . . 7
  77.   How Does One Subscribe to a List?  . . . . . . . . . . . .
  78. . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  79.   How Does One Get Off a List?  . . . . . . . . . . . . . .
  80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  81.   How Does One Find Out What Lists They Are On? . . . . . .
  82. . . . . . . . . . . . . . . . . . . . . 8
  83.   How Does One Find Out Who Else is on a List?  . . . . . .
  84. . . . . . . . . . . . . . . . . . . . . . . 9
  85.   How Does One Find Out What a List is About? . . . . . . .
  86. . . . . . . . . . . . . . . . . . . . . . . 9
  87.   How Does One Get Help From ListProcesssor? . . . . . . . .
  88. . . . . . . . . . . . . . . . . . . . . . 9
  89.   How Does One Change Their Password? . . . . . . . . . . .
  90. . . . . . . . . . . . . . . . . . . . . . . 10
  91.   How Can I Postpone My Mail? . . . . . . . . . . . . . . .
  92. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  93.   How Can I Receive My Mail as A Digest?  . . . . . . . . .
  94. . . . . . . . . . . . . . . . . . . . . . . . 11
  95.   How Do I Resume Mail Delivery?  . . . . . . . . . . . . .
  96. . . . . . . . . . . . . . . . . . . . . . . . . . 11
  97.   How Do I Change My Mailing Address?  . . . . . . . . . . .
  98. . . . . . . . . . . . . . . . . . . . . . . 12
  99.  
  100. An Owner  . . . . . . . . . . . . . . . . . . . . . . . . .
  101. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  102. . . . . . 13
  103.   What is a List Owner? . . . . . . . . . . . . . . . . . .
  104. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  105. 13
  106.   How Do I Obtain the List Reports? . . . . . . . . . . . .
  107. . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  108.   How Do I Subscribe a User?  . . . . . . . . . . . . . . .
  109. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  110.   How Do I Remove Someone From My List?  . . . . . . . . . .
  111. . . . . . . . . . . . . . . . . . . . . 14
  112.   How Do I Get the Information File to Edit?  . . . . . . .
  113. . . . . . . . . . . . . . . . . . . . . . . . . 15
  114.   How Do I Return the Edited Info File?  . . . . . . . . . .
  115. . . . . . . . . . . . . . . . . . . . . . . . . . 15
  116.   How Do I Approve a Message for Posting?  . . . . . . . . .
  117. . . . . . . . . . . . . . . . . . . . . . . 16
  118.   How Do I Discard a Message?  . . . . . . . . . . . . . . .
  119. . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  120.   How Do I Keep Someone From The List?  . . . . . . . . . .
  121. . . . . . . . . . . . . . . . . . . . . . . 17
  122.   How Do I Add an Alias? . . . . . . . . . . . . . . . . . .
  123. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  124.  
  125. Glossary   . . . . . . . . . . . . . . . . . . . . . . . . .
  126. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  127. . . . . . . 18
  128.  
  129. Quick Review - User Requests . . . . . . . . . . . . . . . .
  130. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
  131.   Send Mail to a List . . . . . . . . . . . . . . . . . . .
  132. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  133. . . 19
  134.   Send For Help  . . . . . . . . . . . . . . . . . . . . . .
  135. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  136. . . 19
  137.   Send For What Lists are Available  . . . . . . . . . . . .
  138. . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  139.   Send For Information About a List  . . . . . . . . . . . .
  140. . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  141.   Subscribe to a List  . . . . . . . . . . . . . . . . . . .
  142. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  143. . . 19
  144.   Find Out Which Lists Presently Subscribed To. . . . . . .
  145. . . . . . . . . . . . . . . . . . . . . . . 19
  146.   Find Out Who is Also on the List  . . . . . . . . . . . .
  147. . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  148.   Unsubscribe From a List  . . . . . . . . . . . . . . . . .
  149. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  150.   Change Your List Password  . . . . . . . . . . . . . . . .
  151. . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  152.   Change Mail To Digest Delivery . . . . . . . . . . . . . .
  153. . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  154.   Postpone Mail Delivery . . . . . . . . . . . . . . . . . .
  155. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  156.   Restart Mail Delivery . . . . . . . . . . . . . . . . . .
  157. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  158. . 20
  159.  
  160. Quick Review - Owner Requets . . . . . . . . . . . . . . . .
  161. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
  162.   Request List Reports  . . . . . . . . . . . . . . . . . .
  163. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  164. . 21
  165.   Execute System Request Subscribe . . . . . . . . . . . . .
  166. . . . . . . . . . . . . . . . . . . . . . . . . . 21
  167.   Execute System Request Unsubscribe . . . . . . . . . . . .
  168. . . . . . . . . . . . . . . . . . . . . . . . . 21
  169.   Request List Information File  . . . . . . . . . . . . . .
  170. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
  171.   Return List Information File  . . . . . . . . . . . . . .
  172. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
  173.   Approve Moderated Message For Posting . . . . . . . . . .
  174. . . . . . . . . . . . . . . . . . . . . . . . 21
  175.   Delete Moderated Message  . . . . . . . . . . . . . . . .
  176. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  177.   Ban a User Access to the List  . . . . . . . . . . . . . .
  178. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  179.   Add an Alias For a User  . . . . . . . . . . . . . . . . .
  180. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  181.  
  182. Appendix-A   ListProcessor Commands  . . . . . . . . . . . .
  183. . . . . . . . . . . . . . . . . . . . . . . . . . 23
  184.  
  185. Appendix-B   Owner Functions and Commands . . . . . . . . .
  186. . . . . . . . . . . . . . . . . . . . . . . 27
  187.  
  188.  
  189.  
  190.  
  191. BASICS OF LISTPROCESSOR
  192.  
  193.  
  194. WHAT IS LISTPROCESSOR?
  195.  
  196. ListProcessor  is  a  system that  automates  an  electronic
  197. mailing  lists  and  includes an archive  service  that  was
  198. developed  at Boston University by Anastasios C. Kotsikonas.
  199. This  system allows users to add themselves to mailing lists
  200. supported  by  ListProcessor,  post  messages,  review   the
  201. members   of  a  list,  etc.   The  system  also   maintains
  202. hierarchical archives of files that users may get.  Archives
  203. and  mailing  lists  may  be private,  which  means  that  a
  204. password is required for archive access, and that the  owner
  205. of  a  private  mailing list decides  who  can  or  can  not
  206. subscribe.   List may also be moderated, in which  case  the
  207. owner decides which messages are made public, and which  are
  208. flushed.   This program is available from any of
  209. our  on-line computer systems.  You must have an account  on
  210. a computer that is connected to the Internet network.
  211.  
  212.  
  213. WHAT IS ELECTRONIC MAIL LIST SERVICE?
  214.  
  215. Think of Electronic mail list service (or "Listproc") as  if
  216. it  were the router for the regular postal mail.  It is  the
  217. delivery  of letters or information to members of  a  group.
  218. The   difference  is  that  instead  of  being  handled  and
  219. delivered  by  the postal service to a home or business,  e-
  220. mail  is  carried through a computer network to the computer
  221. of each person who is a member of a list.
  222.  
  223.  
  224. WHAT CAN YOU DO WITH LISTPROCESSOR?
  225.  
  226. You  will mostly be interested in communicating with a group
  227. of  students or colleagues maybe even co-workers on  campus,
  228. but  as  a  member of a network you can include  any  person
  229. nationally or internationally.  An e-mail message sent to  a
  230. list  is  distributed  to all members  of  the  list  within
  231. minutes if not seconds after being sent.
  232.  
  233. You  can  use  a  list as a method of almost instantaneously
  234. communicating with members or a way of keeping a digest  for
  235. a   discussion   group,  where  digests  are   automatically
  236. distributed to subscribed members or mailed upon request.
  237.  
  238. E-mail  communication  to  a list can  be  archived  thereby
  239. allowing   members  and  future  members  access   to   past
  240. correspondence  or  files  at a later  date.   Archives  are
  241. indexed to make access easier to a member request.  Archives
  242. can be searched for particular patterns and searches can  be
  243. an extended expression.
  244.  
  245. You can use a list as a connection to a news group that is a
  246. member  of the Internet.  As a member of your list  you  can
  247. have  items  from  your associated news group  sent  to  all
  248. members  of  the list.  No only will you be able to  receive
  249. news items but you will be able to post to that news group.
  250.  
  251.  
  252. ABOUT THIS DOCUMENT
  253.  
  254. Throughout this document, the following standard methods are
  255. used:
  256.  
  257.   :>   Indicates systems prompt.  This may vary from system
  258. to system depending
  259.        on how it is currently set by the .cshrc or .login
  260. file.
  261.  
  262.   [ ]  < >                    Items encased with these
  263. symbols refer to specific keys on your
  264.                               keyboard.
  265.  
  266.   ()   Items encased with these sysmbols refer to optional
  267. text.
  268.  
  269.   <-   Indicates pressing the <return> or <enter> key.
  270.  
  271.   ^    This is the symbol for the [Ctrl] key.
  272.  
  273.   (    Indicates steps you may need to perform.
  274.  
  275.   user input    You must enter exactly what is specified.
  276.  
  277.   user input      You must supply the variable input where
  278. indicated.
  279.  
  280.   C    Capital letters are used in many examples.  When
  281. entering
  282.        commands, you may use either upper or lower case.
  283.  
  284. Additional information:
  285.  
  286. Glossary:                     There is a glossary located
  287. near the end of this document.
  288.             It contains definitions for terms used in this
  289. document that
  290.             may be unfamiliar to you.
  291.  
  292. Quick Reviews:                The Quick Review section
  293. provides a step-by-step recap of
  294.             instructions, to perform some of the commonly
  295. used features of
  296.             ListProcessor.
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304. USING LISTPROCESSOR
  305.  
  306.  
  307.  
  308. HOW DOES ONE USE LISTPROCESSOR?
  309.  
  310. You   access  ListProcessor  through   one  of  the  on-line
  311. computer  system's  mailers.   For  the  purposes  of   this
  312. document  it is assumed that the user knows how to login  to
  313. one  of  the  on-line systems and use  one  of  the  mailers
  314. available.   If you are unfamiliar with one of the  system's
  315. mailers you can refer to either the man page for mail or the
  316. user  document for pine or other mailer utilities  available
  317. on the system.  To keep things simple the examples are based
  318. on  using  the  systems Berkeley Mailer and unix  operating
  319. system.
  320.  
  321. There  are  two levels of users: a) users who  subscribe  to
  322. lists  in order to send/receive messages and get files  from
  323. archives, and b) list owners who  oversee the functioning of
  324. lists.   There  is of course a system manager that  oversees
  325. the entire operation.
  326.  
  327. List owners have certain privileges: they can add and remove
  328. users  from their lists, reject posting to moderated  lists,
  329. manipulate addresses, etc.
  330.  
  331.  
  332.  
  333. HOW DOES ONE SEND MAIL TO LISTPROCESSOR?
  334.  
  335. You  send  mail to the ListProcessor by entering the  mailer
  336. command  followed by the mail address for the  ListProcessor
  337. and  a  carriage return.  This will start the system's  mail
  338. editor  and the subject prompt will then appear.   You  need
  339. not enter anything at this time but you must type the return
  340. key  to  begin typing requests in the message body. Enter  a
  341. command  the  ListProcessor recognizes.  Enter each  command
  342. request on  a new line. Use the & sign to continue a  single
  343. command request to the next line.
  344.  
  345.        :> mail listproc@cc.wwu.edu <-
  346.  
  347.        Subject: (optional) <-
  348.  
  349.        user-request <-
  350.                          :
  351.                     user-request <-
  352.  
  353.        . <-
  354.  
  355. ListProcessor will process each request  and send a message
  356. upon completion.
  357. HOW DOES ONE SEND MAIL TO A LIST?
  358.  
  359. Sending  mail  to  a  list is the same as  sending  mail  to
  360. another user.   Enter the mail command followed by the  list
  361. address.    Enter  text  in  the  message  body  and   send.
  362. ListProcessor requires that after subscribing to a list that
  363. all  messages and requests be sent from the machine in which
  364. you  sent the subscription request since Listprocessor  uses
  365. the from address to verify subscribers and owners.
  366.  
  367.        mail list-name@domain-address <-
  368.  
  369.        Subject: (optional) <-
  370.  
  371.        message  body <-
  372.  
  373.        . <-
  374.  
  375. The list receives the message and forwards a copy  to all
  376. subscribed members of the list.
  377.  
  378.  
  379. HOW DOES ONE FIND OUT WHAT LISTS ARE AVAILABLE?
  380.  
  381. The first thing that a user will want to do is find out what
  382. lists  are  available for subscription.  To do this  a  user
  383. would send the command request list to the ListProcessor:
  384.  
  385.        :> mail listproc@domain-address <-
  386.  
  387.        Subject: (optional) <-
  388.  
  389.        list <-
  390.  
  391.        . <-
  392.  
  393. ListProcessor responds by sending a return email message
  394. with the lists available.
  395.  
  396.  
  397. HOW DOES ONE SUBSCRIBE TO A LIST?
  398.  
  399. You subscribe to a list by sending a subscribe request  to
  400. ListProcessor.  Type the subscription command in the message
  401. body.   A  subscription request has three parts: the command
  402. subscribe, the list name and the  name that you want to be
  403. known by.
  404.  
  405.        :> mail listproc@domain-address <-
  406.  
  407.        Subject: (optional)<-
  408.  
  409.        subscribe list-name user-name <-
  410.        . <-
  411.  
  412. example: John Doe wants to subscribe to the list cooking
  413. at  school LaChic that has the internet address
  414. LaChicSchool.edu and wants to be known by a different
  415. name.
  416.  
  417.        :> mail listproc@LaChicSchool.edu <-
  418.  
  419.            Subject: (optional)<-
  420.  
  421.             subscribe cooking  Jacque D.<-
  422.  
  423.        . <-
  424.  
  425. ListProcessor receives the request and subscribes  the  send
  426. to  the list requested. ListProcessor sends a return message
  427. informing you of the completion of the subscription request.
  428. The  message  body  may include more than  one  subscription
  429. request as long as each request begins on a new line.
  430.  
  431.  
  432. HOW DOES ONE GET OFF A LIST?
  433.  
  434. You  remove yourself from a list by sending an unsubscribe
  435. or  signoff  request to ListProcessor.  The  unsubscribe
  436. request   has  two  parts:  the  command  unsubscribe   or
  437. signoff and the list name.
  438.  
  439.        :> mail listproc@domain-address <-
  440.  
  441.        Subject: (optional) <-
  442.  
  443.        unsubscribe list-name <-
  444.  
  445.             or
  446.  
  447.        signoff list-name <-
  448.  
  449.        . <-
  450.  
  451. ListProcessor receives the request and removes you from that
  452. list.  ListProcess sends a return message informing  of  the
  453. completion  of the unsubscribe request.  You may  send  more
  454. than  one unsubscribe request as long as each request starts
  455. on a new line.
  456.  
  457.  
  458. HOW DOES ONE FIND OUT WHAT LISTS THEY ARE ON?
  459.  
  460. To find out which lists you have subscribed to send a
  461. which request to ListProcessor.  The request has only one
  462. command, which.
  463.  
  464.        :> mail listproc@domain-address <-
  465.  
  466.        Subject: (optional) <-
  467.  
  468.        which <-
  469.  
  470.        . <-
  471.  
  472. ListProcessor receives the which request  and sends a return
  473. message that includes all the lists in which you are a
  474. subscriber.
  475.  
  476.  
  477. HOW DOES ONE FIND OUT WHO ELSE IS ON A LIST?
  478.  
  479. You  can  find  out  who else is on a list  by  sending  the
  480. review  or  recipients request  to  ListProcessor.   The
  481. request  has two parts: the command recipients or review
  482. and the list that you want to review.
  483.  
  484.        :> mail listproc@domain-address <-
  485.  
  486.        Subject: (optional) <-
  487.  
  488.        recipients list-name <-
  489.  
  490.             or
  491.  
  492.        review list-name <-
  493.  
  494.        . <-
  495.  
  496. ListProcessor  receives your request  and   sends  a  return
  497. message that includes all the non-concealed subscribers  for
  498. the  requested list.  The message body may include a  review
  499. request  for  more  than one list as long  as  each  request
  500. starts on a new line.
  501.  
  502.  
  503.  
  504. HOW DOES ONE FIND OUT WHAT A LIST IS ABOUT?
  505.  
  506. You can find out information about a list by sending the
  507. info request to ListProcessor.
  508.  
  509.        :> mail listproc@domain-address <-
  510.  
  511.        Subject: (optional) <-
  512.  
  513.        info list-name <-
  514.  
  515.        . <-
  516.  
  517. ListProcessor receives the information request and  sends  a
  518. return message that includes the information about the  list
  519. requested.  The message body may include an info request for
  520. more  than one list as long as each request starts on a  new
  521. line.
  522.  
  523.  
  524.  
  525. HOW DOES ONE GET HELP FROM LISTPROCESSOR?
  526.  
  527. You  can  obtain  help  by sending  the  help  request  to
  528. ListProcessor.   The  request has  two  parts:  the  command
  529. help and a topic, the topic is optional.
  530.  
  531.        :> mail listproc@domain-address <-
  532.  
  533.        Subject: (optional) <-
  534.  
  535.        help (topic) <-
  536.  
  537.        . <-
  538.  
  539. ListProcessor  receives  the  request  and  sends  a  return
  540. message  that  includes all the commands that  ListProcessor
  541. recognizes.   For  a  help  request  that  has   a   topic
  542. ListProcessor sends the help information about that topic.
  543.  
  544.  
  545. HOW DOES ONE CHANGE THEIR PASSWORD?
  546.  
  547. You  change your list password by sending the set  request
  548. to  ListProcessor.  The request has five parts: the  command
  549. set,  the  list name, password, your current password  and
  550. the new password.
  551.  
  552.        :> mail listproc@ domain-address <-
  553.  
  554.        Subject: (optional) <-
  555.  
  556.        set list-name password current-password new-password
  557. <-
  558.  
  559.        . <-
  560.  
  561. ListProcessor  receives your request, changes your  password
  562. and  sends a return message that includes your new password.
  563. Passwords are needed for certain functions such as accessing
  564. private archives,  requesting private digests and etc..
  565.  
  566.  
  567.  
  568.  
  569. HOW CAN I POSTPONE MY MAIL?
  570.  
  571. You  can delay the delivery of mail from the list by sending
  572. the  set request to ListProcessor.  The request  has  four
  573. parts: the command set, the list name, the keywords mail
  574. and postpone.
  575.  
  576.        :> mail listproc@domain-address <-
  577.  
  578.        Subject: (optional) <-
  579.  
  580.        set list-name mail postpone <-
  581.  
  582.        . <-
  583.  
  584. ListProcessor receives your request, changes the mail status
  585. for the list and sends a return message.  The return message
  586. states mail postponed.
  587.  
  588.  
  589. HOW CAN I RECEIVE MY MAIL AS A DIGEST?
  590.  
  591. You  can  have your mail delivered in digest form  that  is,
  592. collect  all  message sent to the list and deliver  after  a
  593. certain  number of hours have elpased. You change your  mail
  594. status   to   digest  by  sending  the  set   request   to
  595. ListProcessor.   The  request has four  parts:  the  command
  596. set, list name,  the keywords mail and digest.
  597.  
  598.        :> mail listproc@domain-address <-
  599.  
  600.        Subject: (optional) <-
  601.  
  602.        set list-name mail digest <-
  603.  
  604.        . <-
  605.  
  606. ListProcessor receives your request, changes the mail status
  607. to digest and returns a message to you about the change.
  608.  
  609.  
  610. HOW DO I RESUME MAIL DELIVERY?
  611.  
  612. You  restart the delivery of your mail by sending the  set
  613. request  to  ListProcessor.  The set mail request  has  four
  614. parts:  the  command  set, the  list  name,  the  keywords
  615. mail,  and ack or noack.  The keyword ack  sets  the
  616. mail  status for the list mailer to send a copy of your mail
  617. messages  back  to you that you send.  The  keyword  noack
  618. sets  the mail status so that the mailer does not to send  a
  619. copy of each message back to you that you send.
  620.  
  621.        :> mail listproc@domain-address <-
  622.  
  623.        Subject: (optional) <-
  624.  
  625.        set list-name mail ack <-
  626.  
  627.                      or
  628.  
  629.        set list-name mail noack <-
  630.  
  631.        . <-
  632.  
  633.  
  634. ListProcessor  receives your request, makes  the  change  to
  635. your   mail  status  and  returns  a  message  stating   the
  636. completion of the request.
  637.  
  638.  
  639.  
  640.  
  641. HOW DO I CHANGE MY MAILING ADDRESS?
  642.  
  643. You  can  change your mailing address by sending  the  set
  644. request  to ListProcessor.  The request has five parts:  the
  645. command  set, list name, the keyword address, your  list
  646. password, and the new address.
  647.  
  648.        :> mail listproc@domain-address <-
  649.  
  650.        Subject: (optional) <-
  651.  
  652.        set list-name address your-password new-address <-
  653.  
  654.        . <-
  655.  
  656.  
  657. ListProcessor receives your request, changes the address and
  658. sends a return message that it has changed your address.
  659.  
  660.  
  661. See appendix A. for user-requests that ListProcessor
  662. accepts.
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670. AN OWNER
  671.  
  672.  
  673. WHAT IS A LIST OWNER?
  674.  
  675. The   list   owner  determines  the  type   of   list   that
  676. ListProcessor   will  serve  and  takes  on   the   job   of
  677. administering the list. The list owner is not required to be
  678. a  member of the list.  A list owner can administer  a  list
  679. even  if the owner does not have an account on the same site
  680. in  which  the  ListProcessor resides and  may  be  remotely
  681. located.  To administer a list the owner is given access  to
  682. certain commands that ListProcessor recognize only from  the
  683. owner.   The list owner must perform on a regular basis  the
  684. housekeeping of removing the list reports. This housekeeping
  685. function  is  done by the owner requesting ListProcessor  to
  686. send  the owner the list reports.  A list owner can  request
  687. ListProcessor to execute commands on behalf of a user.   The
  688. list  owner can edit certain files that belong to the  list.
  689. The  list owner can request ListProcessor to ignore a  user.
  690. The  list owner can manipulate addresses and change   system
  691. files.   For  a  moderated list the list owner approves  all
  692. messages  for  posting by the list or sends  a  request  for
  693. ListProcessor  to  discard  a message.   All  owner  command
  694. requests  require that the owner include the lists password
  695. and  must  be sent from the machine in which the  owner  has
  696. specified when starting the list.
  697.  
  698.  
  699. HOW DO I OBTAIN THE LIST REPORTS?
  700.  
  701. You  obtain the list reports by sending the request  command
  702. report to ListProcessor.  The request has three parts: the
  703. command report, the list name and the list password.
  704.  
  705.        :> mail listproc@domain-address <-
  706.  
  707.        Subject: (optional) <-
  708.  
  709.        reports list-name owners-list-password <-
  710.  
  711.        . <-
  712.  
  713. ListProcessor receives the request and returns to the  owner
  714. two report files.   The first is the current report file and
  715. the  second  is  the  old report file.  After  ListProcessor
  716. sends the owner the two report files the old file is removed
  717. from  the system and the new report file is held as the  old
  718. file.
  719.  
  720.  
  721. HOW DO I SUBSCRIBE A USER?
  722.  
  723. You  can  subscribe a new member to the list by sending  the
  724. request command system to ListProcessor.  The request  has
  725. eight  parts:  the  command system,  the  list  name,  the
  726. owners  list  password,  the new users  address,  the  key
  727. character  #, the command subscribe, the list  name  and
  728. the  new users name or name that they want to be known  by.
  729. If the command can not be completed on one line then the key
  730. character  & is placed at end of the line to be  continued
  731. and the command is completed on the next line.
  732.  
  733.      :> mail listproc@domain-address <-
  734.  
  735.      Subject: (optional) <-
  736.  
  737.      system list-name owners-list-password user-address &
  738.  
  739.          #subscribe list-name user-name <-
  740.  
  741.      . <-
  742.  
  743. example: Jane S. is the owner of the list advnPhysics at
  744. Miscontonic University, that has the domain address
  745. misunv.edu and wants to subscribe a fellow associate to
  746. the list.  She would the send the following request:
  747.  
  748.      :> mail listproc@misunv.edu <-
  749.  
  750.      Subject: (optional) <-
  751.  
  752.    system advnPhysics qark fienstien@misunv.edu #subscribe
  753. advnPhysics Fienstien
  754.  
  755.      . <-
  756.  
  757. ListProcessor receives the request, adds the new user to the
  758. list, sends a subscription message to the new user and sends
  759. a successful completion message to the owner.  The owner may
  760. subscribe  more than one user to the list by  starting  each
  761. request on a new line.
  762.  
  763. An  alternate method for adding a new member to a list is to
  764. use  the  request command put."  The put request requires
  765. at  least  two  lines  and the &  does  not  appear  as  a
  766. continuation for the second line.  The first line  has  four
  767. parts:  the  command put," the list name, the owners  list
  768. password and the keyword subscribers."  The following  line
  769. has  five  parts:  the new users address, the  mail  status
  770. keyword ack" for acknowledge, the new users list password,
  771. the  conceal  status keyword no and the new  users  name.
  772. Note  that  the  list  password should  never  be  the  same
  773. password used to log on with.
  774.  
  775.        :> mail listproc@domain-address <-
  776.  
  777.        Subject: (optional) <-
  778.  
  779.        put list-name owners-list-password subscribers <-
  780.  
  781.        user-address ack password no user-name <-
  782.  
  783.        . <-
  784.  
  785. example:
  786.  
  787.        :> mail listproc@domain-address <-
  788.  
  789.        Subject: (optional) <-
  790.  
  791.        put advnPhysics qark subscribers <-
  792.  
  793.        feinstein@misunv.edu ack XXX no Feinstein <-
  794.  
  795.        . <-
  796.  
  797. ListProcessor receives the request and performs the  command
  798. for every line following the line in which the command put
  799. appears.   After  completing  the  subscription  request   a
  800. ListProcessor sends the completion message to the owner, but
  801. no   message   is  sent  to  a  new  member.   ListProcessor
  802. recognizes every line that follows a put command  as  part
  803. of that request.  The owner can subscribe more than one user
  804. by continuing to add each new subscriber on a new line.
  805.  
  806.  
  807. HOW DO I REMOVE SOMEONE FROM MY LIST?
  808.  
  809. You  remove  a  user  from a list by  sending   the  request
  810. command system to ListProcessor.  The deletion request has
  811. seven  parts:  the  command system,  the  list  name,  the
  812. owners  list password, the user address to be removed,  the
  813. key  character #, the command unsubscribe  or  signoff
  814. request and the list name.
  815.  
  816.      :> mail listproc@domain-address <-
  817.  
  818.      Subject: (optional) <-
  819.  
  820.    system list-name owners-list-password user-address
  821. #unsubscribe list-name <-
  822.  
  823.                  or
  824.  
  825.      system list-name owners-list-password user-address
  826. #signoff list-name <-
  827.  
  828.      . <-
  829.  
  830. ListProcessor receives the request, removes the user from
  831. the list, sends the owner the completion message and sends
  832. the removed user a message about their removal.
  833.  
  834.  
  835.  
  836.  
  837.  
  838. HOW DO I GET THE INFORMATION FILE TO EDIT?
  839.  
  840. To  receive  the information file for editing you  send  the
  841. request  command edit to ListProcessor.  The  request  has
  842. four  parts: the command edit, the list name, the  owners
  843. list password and the keyword info.
  844.  
  845.        :> mail listproc@domain-address <-
  846.  
  847.        Subject: (optional) <-
  848.  
  849.        edit list-name owners-list-password info <-
  850.  
  851.        . <-
  852.  
  853. ListProcessor receives the request and sends the info file
  854. to the owner.
  855.  
  856.  
  857. HOW DO I RETURN THE EDITED INFO FILE?
  858.  
  859. You  return  the  edited info file by adding  the  request
  860. command put to the first line of the info file and  send
  861. it  to  ListProcessor.   The request  has  four  parts:  the
  862. command put, the list name, the owners list password  and
  863. the keyword info.
  864.  
  865.        :> mail listproc@domain-address <-
  866.  
  867.        Subject: (optional) <-
  868.  
  869.        put list-name owners-list-password info <-
  870.  
  871.        (edited info file) or (text to put into info file)
  872.  
  873.        . <-
  874.  
  875. ListProcessor  receives the request,  installs  the  new  or
  876. edited  info  file  and  sends the  successful  completion
  877. message to the owner.
  878.  
  879.  
  880. HOW DO I APPROVE A MESSAGE FOR POSTING?
  881.  
  882. You  will  receive a copy of the message that  will  require
  883. your  approval before ListProcessor sends a copy to  members
  884. of  the list.  Instructions are appended to the beginning of
  885. the  message on how to approve the message for posting.  For
  886. a  message  that is received with a tag number  the  request
  887. command approve is sent to ListProcessor. The request  has
  888. four  parts:  the  command approve,  the  list  name,  the
  889. owners list password and the message tag number.
  890.  
  891.        :> mail listproc@cc.wwu.edu <-
  892.  
  893.        Subject: (optional) <-
  894.  
  895.        approve list-name owners-list-password tag-number <-
  896.  
  897.        . <-
  898.  
  899. ListProcessor  receives the request, sends  a  copy  of  the
  900. message  associated with the tag number to  all  subscribers
  901. and returns a completion message to the owner.
  902.  
  903.  
  904. HOW DO I DISCARD A MESSAGE?
  905.  
  906. Messages that have not been approved for posting to  a  list
  907. reside in the lists moderated file.  You delete a message
  908. from  the  moderated  file by sending  a  request  command
  909. discard to ListProcessor.  The request has four parts: the
  910. command  discard, the list name, the owners list password
  911. and the message tag number.
  912.  
  913.        :> mail listproc@domain-address <-
  914.  
  915.        Subject: (optional) <-
  916.  
  917.        discard list-name owners-list-password tag-number <-
  918.  
  919.        . <-
  920.  
  921. ListProcessor  receives  the request,  deletes  the  message
  922. associated  with  the  tag number and returns  a  completion
  923. message to the owner.
  924.  
  925.  
  926. HOW DO I KEEP SOMEONE FROM THE LIST?
  927.  
  928. You can prevent someone from posting messages to the list by
  929. sending  the  command request put to  ListProcessor.   The
  930. request  has four parts: the command put, the  list  name,
  931. the  owners  list  password, the keyword ignore  and  the
  932. users address as subscribed.
  933.  
  934.        :> mail listproc@domain-address <-
  935.  
  936.        Subject: (optional) <-
  937.  
  938.        put list-name owners-list-password ignore users-
  939. subscribed-address <-
  940.  
  941.        . <-
  942.  
  943. ListProcessor receives the request, appends the user to  the
  944. lists ignore file and returns the task completion message
  945. to  the  owner.  A user may be subscribed under one or  more
  946. different  user addresses or by an aliases therefore  it  is
  947. suggested  that  the  owner request  copies  of  the  lists
  948. alias  and subscribers files by using the edit request
  949. command.
  950.  
  951.  
  952. HOW CAN I ADD AN ALIAS?
  953.  
  954. You can add an alias by sending the request command put to
  955. ListProcessor.   The  request has  six  parts:  the  command
  956. put, the list name, the owners list password, the keyword
  957. alias, the new alias and the users address as subscribed.
  958.  
  959.        :> mail listproc@cc.wwu.edu <-
  960.  
  961.        Subject: (optional) <-
  962.  
  963.        put list-name owners-list-password alias users-new-
  964. alias users-address <-
  965.  
  966.        . <-
  967.  
  968. ListProcess receives the request, appends the users new
  969. alias to the lists aliases file and sends the successful
  970. completion message to the user.
  971. GLOSSARY
  972.  
  973. address   A specific combination of characters and letters
  974. which uniquely
  975.           defines where a mail message is to be delivered.
  976. The format
  977.           will vary depending on the on-line system used by
  978. the sender as
  979.           well as the recipient.
  980.  
  981. e-mail    An acronym for electronic mail.
  982.  
  983.  
  984. Internet                      Refers to a global network of
  985. regional and national computer
  986.           networks.  Many health, educational, research,
  987. government,
  988.           Military and commercial enterprises are located on
  989. the
  990.           Internet.
  991.  
  992. list                          A mailing list that members
  993. subscribe to in order to receive
  994.           a copy of posted messages.
  995.  
  996. Listproc                      The system listprocessor that
  997. routes mail to particular
  998.           mailing lists and services other user requests.
  999.  
  1000. log on    A procedure which includes the steps of providing
  1001. a login-name
  1002.           and password for access to an on-line system.
  1003.  
  1004. login-name                    The name assigned to a user to
  1005. be entered during the log on
  1006.           process.  This name is also used when addressing
  1007. mail
  1008.           messages.
  1009.  
  1010. message text                  This refers to the actual body
  1011. of your mail message.
  1012.  
  1013.  
  1014. prompt    A character or message provided by the computer to
  1015. indicate that
  1016.           it is ready to accept keyboard input.
  1017.  
  1018. on-line system  Generally refers to the more distant and
  1019. larger of two
  1020.           connected computers.
  1021.  
  1022. syntax    A text expression recognized by the listprocessor.
  1023.  
  1024. user      The name which refers to anyone using a computer.
  1025.  
  1026.  
  1027. QUICK REVIEW SECTION          USER REQUESTS
  1028.  
  1029. SEND MAIL TO A LIST
  1030.  
  1031.      Type list-name@cc.wwu.edu
  1032.  
  1033.      Type text in message body
  1034.  
  1035. SEND FOR HELP
  1036.  
  1037.      Type listproc@domain-address
  1038.  
  1039.      Type help (topic) in message body
  1040.  
  1041. SEND FOR WHAT LISTS ARE AVAILABLE
  1042.  
  1043.      Type listproc@domain-address
  1044.  
  1045.      Type list in message body
  1046.  
  1047. SEND FOR INFORMATION ABOUT A LIST
  1048.  
  1049.      Type listproc@domain-address
  1050.  
  1051.      Type info list-name in message body
  1052.  
  1053. SUBSCRIBE TO A LIST
  1054.  
  1055.      Type listproc@domain-address
  1056.  
  1057.      Type subscribe list-name your-name in message body
  1058.  
  1059. FIND OUT WHICH LIST PRESENTLY SUBSCRIBED TO
  1060.  
  1061.      Type listproc@domain-address
  1062.  
  1063.      Type which in message body
  1064.  
  1065. FIND OUT WHO IS ALSO ON THE LIST
  1066.  
  1067.      Type listproc@domain-address
  1068.  
  1069.      Type review list-name in message body
  1070.           or
  1071.      Type recipients list-name in message body
  1072. UNSUBSCRIBE FROM A LIST
  1073.  
  1074.      Type listproc@domain-address
  1075.  
  1076.      Type unsubscribe list-name in message body
  1077.                or
  1078.      Type signoff list-name in message body
  1079.  
  1080. CHANGE YOUR LIST PASSWORD
  1081.  
  1082.      Type listproc@domain-address
  1083.  
  1084.      Type set list-name password current-password new-
  1085. password in message body
  1086.  
  1087. CHANGE MAILING TO DIGEST DELIVERY
  1088.  
  1089.      Type listproc@domain-address
  1090.  
  1091.      Type set list-name mail digest in message body
  1092.  
  1093. POSTPONE MAIL DELIVERY
  1094.  
  1095.      Type listproc@domain-address
  1096.  
  1097.      Type set list-name mail postpone in message body
  1098.  
  1099. RESTART MAIL DELIVERY
  1100.  
  1101.      Type listproc@domain-address
  1102.  
  1103.      Type set list-name mail ack in message body
  1104.                or
  1105.      Type set list-name mail noack in message body
  1106.  
  1107. CONCEAL NAME FROM REVIEW REQUEST
  1108.  
  1109.      Type listproc@domain-address
  1110.  
  1111.      Type set list-name conceal yes in message body
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118. QUICK REVIEW             OWNER REQUESTS
  1119.  
  1120. REQUEST LIST REPORTS
  1121.  
  1122.      Type mail listproc@domain-address
  1123.  
  1124.           Type reports list-name list-password  in message
  1125. body
  1126.  
  1127. EXECUTE  SYSTEM REQUEST SUBSCRIBE
  1128.  
  1129.           Type mail listproc@domain-address
  1130.  
  1131.           Type system list-name list-password user-address
  1132. #subscribe list-name user in            message body
  1133.  
  1134. EXECUTE  SYSTEM REQUEST UNSUBSCRIBE
  1135.  
  1136.           Type mail listproc@domain-address
  1137.  
  1138.           Type system list-name list-password user-address
  1139. #unsubscribe list-name in               message body
  1140.                     or
  1141.      Type system list-name list-password user-address
  1142. #signoff list-name in                   message body
  1143.  
  1144. REQUEST LIST INFORMATION FILE
  1145.  
  1146.      Type mail listproc@domain-address
  1147.  
  1148.           Type edit list-name list-password info in message
  1149. body
  1150.  
  1151. RETURN LIST INFORMATION FILE
  1152.  
  1153.      Type mail listproc@domain-address
  1154.  
  1155.           Type put list-name list-password info in message
  1156. body
  1157.  
  1158.      Type mailer command to include edited message or file
  1159. in message body
  1160.  
  1161. APPROVE MODERATED MESSAGE FOR POSTING
  1162.  
  1163.      Type mail listproc@domain-address
  1164.  
  1165.           Type approve list-name list-password tag-number in
  1166. message body
  1167.  
  1168.  
  1169. DELETE MODERATED MESSAGE
  1170.  
  1171.      Type mail listproc@domain-address
  1172.  
  1173.           Type discard list-name list-password tag-number in
  1174. message body
  1175.  
  1176. BAN A USER ACCESS TO THE LIST
  1177.  
  1178.      Type mail listproc@domain-address
  1179.  
  1180.           Type put list-name list-password ignore users-
  1181. subscribed-address in message                body
  1182.  
  1183. ADD AN ALIAS FOR A USER
  1184.  
  1185.      Type mail listproc@domain-address
  1186.  
  1187.           Type put list-name list-password alias users-
  1188. alias users-subscribed-address in                message
  1189. body
  1190. APPENDIX - A       ListProcessor Commands
  1191.  
  1192.  
  1193.                       ListProcessor 6.0
  1194.  
  1195. Here   is  a  brief  description  of  the  set  of  requests
  1196. recognized  by  ListProcessor.  Everything appearing  in  []
  1197. below  is optional; everything appearing in <> is mandatory;
  1198. all  arguments are case insensitive. The vertical bar  ("|")
  1199. is  used  as  a  logical OR operator between the  arguments.
  1200. Requests  may be abbreviated, but you must specify at  least
  1201. the first three characters.
  1202.  
  1203. Keep in mind that when referring to a <list>, that list  may
  1204. be  of  two kinds: local or remote, unless otherwise  noted.
  1205. When  referring  to  a  local list,  your  request  will  be
  1206. immediately  processed; when referring to a remote  list  (a
  1207. list served by another ListProcessor which this system knows
  1208. about), your request will be appropriately forwarded.  Issue
  1209. a  'lists'  request to get a listing of all local and  known
  1210. remote lists to this ListProcessor.
  1211.  
  1212.  
  1213. Recognized requests are:
  1214.  
  1215.  
  1216. help [topic]
  1217. ------------
  1218. Without   arguments,  this  file.  Otherwise  get   specific
  1219. information on the selected topic. Topics may also refer  to
  1220. requests.  To  learn more about this system  issue  a  'help
  1221. Listproc' request. To get a listing of all available topics,
  1222. generate  an  error message by sending a bogus request  like
  1223. 'help me'.
  1224.  
  1225.  
  1226. set <list> [<option> <arg[s]>]
  1227. ------------------------------
  1228. Without  the  optional arguments, get a list of all  current
  1229. settings for the specified list. Otherwise change the option
  1230. to a new value for that list. Issue a 'help set' request for
  1231. more information.
  1232.  
  1233.  
  1234. subscribe <list> <your name>
  1235. ----------------------------
  1236. The only way to subscribe to a list.
  1237.  
  1238.  
  1239. unsubscribe <list>
  1240. signoff <list>
  1241. ------------------
  1242. Two ways of removing yourself from the specified list.
  1243.  
  1244.  
  1245. recipients <list>
  1246. review <list>
  1247. -----------------
  1248. Get a listing of all non-concealed people subscribed to the
  1249. specified list.
  1250.  
  1251.  
  1252. information <list>
  1253. ------------------
  1254. Get information about the specified list.
  1255.  
  1256.  
  1257. statistics <list> {[subscriber email address(es)] | [-all]}
  1258. -----------------------------------------------------------
  1259. Get  a  listing of non-concealed subscribers along with  the
  1260. number  of  messages  each  one of  them  has  sent  to  the
  1261. specified  list. If the optional email addresses are  given,
  1262. then statistics will be collected for these users only.  For
  1263. example:
  1264.  
  1265.   stat foo user1@domain user2@domain
  1266.  
  1267. will generate statistics about these two subscribers. "-all"
  1268. lists statistics for all users that have posted on the  list
  1269. (whether currently subscribed to not).
  1270.  
  1271. run <list> [<password> <cmd [args]>]
  1272. ------------------------------------
  1273. Run  the  specified command with the optional arguments  and
  1274. receive  the  output from stdout and/or  stderr.  To  get  a
  1275. listing   of  all  available  commands  to  run,  omit   the
  1276. arguments,  i.e. issue a 'run <list>' request. You  have  to
  1277. belong  to  the specified list, and must have  obtained  the
  1278. password from the list's owner; the owner's address  may  be
  1279. found  in  the  Errors-To: header  line  of  each  delivered
  1280. message. <list> may be local only.
  1281.  
  1282.  
  1283. lists
  1284. -----
  1285. Get  a  list of all local mailing lists that are  served  by
  1286. this server, as well as of all known remote lists.
  1287.  
  1288.  
  1289. index [archive | path-to-archive] [/password] [-all]
  1290. ----------------------------------------------------
  1291. Get  a  list of files in the selected archive, or the master
  1292. archive  if  no  archive was specified.  If  an  archive  is
  1293. private, you have to provide its password as well.
  1294.  
  1295.  
  1296. get <archive | path-to-archive> <file> [/password] [parts]
  1297. ----------------------------------------------------------
  1298. Get the requested file from the specified archive. Files are
  1299. usually split in parts locally, and in such a case you  will
  1300. receive  the file in multiple email messages --  an  'index'
  1301. request  tells  you how many parts the file has  been  split
  1302. into,  and their sizes; if you need to obtain certain parts,
  1303. specify  them  as  optional  arguments.  If  an  archive  is
  1304. private, you have to provide its password as well.
  1305.  
  1306. view <archive | path-to-archive>] [/password] [parts]
  1307. -----------------------------------------------------
  1308. Same  as  "get"  but in interactive mode just catenates  the
  1309. file on the screen.
  1310.  
  1311. search <archive | path-to-archive>] [/password] [-all]
  1312. <pattern>
  1313. ------------------------------------------------------------
  1314. ----
  1315. Search  all files of the specified archive (and all  of  its
  1316. subarchives if -all is specified) for lines that  match  the
  1317. pattern.  The  pattern  can  be  an  egrep(1)-style  regular
  1318. expression   with  support  for  the  following   additional
  1319. operators: '~' (negation), '|' and '&' (logical OR and AND),
  1320. '<'  '>'  (group  regular expressions). The pattern  may  be
  1321. enclosed  in  single or double quotes.  Note: . matches  any
  1322. character including new line.
  1323.  
  1324. fax <fax-number> <archive | path-to-archive> <file>
  1325. [/password] [parts]
  1326. ------------------------------------------------------------
  1327. -----------
  1328. Same as 'get', but it faxes you the files instead to the
  1329. specified number.
  1330.  
  1331. release
  1332. -------
  1333. Get information about the current release of this
  1334. ListProcessor system.
  1335.  
  1336.  
  1337. which
  1338. -----
  1339. Get a listing of local mailing lists to which you have
  1340. subscribed.
  1341.  
  1342. ============================================================
  1343. ====
  1344.  
  1345. The  requests  below  are list owner specific.  List  owners
  1346. should  contact  the  system's manager for  extensive  usage
  1347. information:
  1348.  
  1349.  
  1350. reports <list> <password>
  1351. -------------------------
  1352. Obtain all reports about the specified local list.
  1353.  
  1354.  
  1355.  
  1356. edit <list> <password> <file>
  1357. -----------------------------
  1358. Obtain the specified file for editing.
  1359.  
  1360.  
  1361. put <list> <password> <keyword> [args]
  1362. --------------------------------------
  1363. Manipulate addresses and change system files.
  1364.  
  1365.  
  1366. approve <list> <password> <tag>
  1367. -------------------------------
  1368. Approve the message identified by the tag number for posting
  1369. to the specified moderated list.
  1370.  
  1371.  
  1372. discard <list> <password> <tag>
  1373. -------------------------------
  1374. Discard the message identified by the tag number sent to the
  1375. specified moderated list.
  1376. ============================================================
  1377. ====
  1378.  
  1379. In addition, help is available on the following topic(s):
  1380.  
  1381. live
  1382. ----
  1383. Learn how to connect to this ListProcessor over the Internet
  1384. for live processing of your requests.
  1385.  
  1386. Listproc
  1387. --------
  1388. Learn more about this system and list management software in
  1389. general.
  1390.  
  1391.  
  1392. Appendix - B        Owner Functions and Commands
  1393.  
  1394.  
  1395. List Owner
  1396.  
  1397. As   owner   of   a  list  you  are  responsible   for   the
  1398. administration of the list.  A list owner is not required to
  1399. be a member of the list.  A list owner can administer a list
  1400. even  if the owner does not have an account on the same site
  1401. in  which ListProcessor resides and may be remotely located.
  1402. Lists  that are not open for posting by unsubscribed members
  1403. require  the owner's approval for posting mail to the  list.
  1404. Each  list  must have at least one owner.  The owners  of  a
  1405. list  have special privileges: they may issue requests on  a
  1406. user's  behalf  (add  subscriber, remove  subscriber,  etc.)
  1407. overriding system restrictions set on subscribers  (disabled
  1408. commands  for a list), obtain reports about the  lists  they
  1409. administer, append to the.aliases and .ignored files, change
  1410. the  welcoming (.welcome) and information (.info)  messages,
  1411. as  well as other system files such as the subscribers  file
  1412. (.subscribers), the news file (.news), and  the  peers  file
  1413. (.peer).   In  addition, the list may be moderated  and  the
  1414. owner may receive various error messages pertaining to their
  1415. lists.  All administrative requests are author authenticated
  1416. and  password protected.  In case a message cannot be author
  1417. authenticated, the list's owner and manager are notified.
  1418.  
  1419. List  owners  may not add restricted users to a  list;  this
  1420. service  can  be  provided by contacting the ListProcessor's
  1421. manager.
  1422.  
  1423. A  list  owner  has the option of receiving copies  of  user
  1424. requests  and/or  error  messages.   Examples  are   invalid
  1425. postings, syntax errors on requests, etc.  These options are
  1426. described in the following sections.
  1427.  
  1428.  
  1429. SUBSCRIBE OTHERS TO A LIST
  1430.  
  1431. There are two ways in which an owner can add someone to
  1432. their list.  The first method is by using the command
  1433. request system and the second is by using the put request.
  1434. When using the command request system the owner includes
  1435. their list name, list password, the user's address, the
  1436. command request subscribe, the list name and the user's
  1437. name.
  1438.  
  1439.      :> mail listproc@domain-address <-
  1440.  
  1441.      Subject: (optional) <-
  1442.  
  1443.      system list-name list-password user-address #subscribe
  1444. list user-name <-
  1445.  
  1446.      . <-
  1447.  
  1448. ListProcessor receives the system request, subscribes the
  1449. new user and returns a message to the new user informing
  1450. them of the subscription.
  1451.  
  1452. When  using  the put request the owner includes  the  list
  1453. name, owners list password, the keyword subscribers on  the
  1454. first line and each new user on a subsequent new line.   The
  1455. line  to  add the new users consists of the users  address,
  1456. mail  status,  the owner defined users list  password,  the
  1457. conceal  status and the users name or name  that  the  user
  1458. wants to be known by.
  1459.  
  1460.      :> mail listproc@domain-address <-
  1461.  
  1462.      Subject: (optional) <-
  1463.  
  1464.      put list-name list-password #subscribe list user-name <-
  1465.  
  1466.      user-address ack XXX no users-name <-
  1467.  
  1468.      . <-
  1469.  
  1470. ListProcessor receives the put request, appends the new
  1471. users to the subscribers file and returns the completion
  1472. message to the owner.  No message is sent to the new
  1473. subscriber about being added to a list.
  1474.  
  1475. example:
  1476.  
  1477.      put advPhysics qark subscribers
  1478.      JaneS@misunv.edu ack XXI no Jane Smith
  1479.      MarkD@misunv.edu ack XXII no Mark Downs
  1480.      JohnU@misunv.edu ack XXIII no John Uptown
  1481.  
  1482. Every line that follows the put command is treated as
  1483. belonging to that command request therefore no other
  1484. requests can be made in that message.
  1485.  
  1486.  
  1487.  
  1488.  
  1489. OWNER PREFERENCES
  1490.  
  1491. The  primary  owner  may wish to receive copies  of  certain
  1492. replies  to  user  requests (such as  subscribe),  of  error
  1493. conditions, (rejected postings, invalid requests, etc.),  or
  1494. on  all  cases.  These preferences are listed in the  owners
  1495. file on the line owners address and list are defined.  Valid
  1496. preferences are:
  1497.  
  1498.   CCSET             - copy on set requests.
  1499.  
  1500.   CCSUBSCRIBE       - copy on subscribe requests.
  1501.  
  1502.   CCUNSUBSCRIBE     - copy on unsubscribe requests.
  1503.  
  1504.   CCRECIPIENTS      - copy on recipients requests.
  1505.  
  1506.   CCINFORMATION     - copy on information requests.
  1507.  
  1508.   CCSTATISTICS      - copy on statistics requests.
  1509.  
  1510.   CCRUN             - copy on run requests.
  1511.  
  1512.   CCPRIVATE         - copy on requests rejected because they
  1513. are not open
  1514.                       only to the list's members.
  1515.  
  1516.   CCERRORS          - copy on various error conditions
  1517.  
  1518.   CCALL             - all the above.
  1519.  
  1520. Owner   preferences  are  optional  and  are  set   by   the
  1521. ListProcessor manager.
  1522. Contact  the manager if any preferences need to be added  or
  1523. removed.
  1524.  
  1525.  
  1526. OWNER ADMINISTRATIVE COMMANDS
  1527.  
  1528. The  following requests may be issued by a list's owner.   A
  1529. command may be continued on more then one line by using  the
  1530. & character at the end of each line.
  1531.  
  1532. SYSTEM
  1533.  
  1534.      syntax> system list-name list-password user-address
  1535. #user-request
  1536.  
  1537. This  command request overrides all system restrictions  and
  1538. executes  user-request on behalf of the  user-address;  this
  1539. address  must  appear as listed in the ".subscribers"  file,
  1540. where  applicable.   The most frequent  use  of  the  system
  1541. request  is  to  subscribe a user to a private  list.    For
  1542. example  to subscribe  user johnD@henson.cc.wwu.edu  to  the
  1543. list  alpha enter:
  1544.  
  1545.                               mail listproc@cc.wwu.edu <-
  1546.  
  1547.                               subject: <-
  1548.  
  1549.                               system alpha alpha_password
  1550. johnD@cc.wwu.edu #subscribe & <-
  1551.  
  1552.                               alpha Johnny D. <-
  1553.  
  1554.                               . <-
  1555.  
  1556. If  a  user-request refers to a list, this list  must  be  a
  1557. list,  so  that a list's owner may not have privileges  over
  1558. another  list's affairs.  Note that all replies about  user-
  1559. request  are forwarded to the user-address, not  the  owner;
  1560. therefore  ,  care should be taken to avoid  syntax  errors.
  1561. The  system request is not subject to restrictions, disabled
  1562. requests, and private list subscription verification  (still
  1563. subject  to  private  list review  as  outlined  above,  and
  1564. batching).  To remove a member from his list, the owner  may
  1565. issue the following request:
  1566.  
  1567.   system alpha alpha_password johnD@ cc.wwu.edu #unsubscribe
  1568. alpha
  1569.  
  1570. To bypass restrictions and review his list, the owner may
  1571. issue the following:
  1572.  
  1573.   system alpha alpha_password johnD@ cc.wwu.edu #review
  1574. alpha
  1575.  
  1576. ListProcessor allows for more then one command to be sent in
  1577. the body of the message.  It is suggested that when multiple
  1578. commands are to be isussed to the ListProcessor that a  text
  1579. editor  be  used to create the body of the message  and  the
  1580. file  containing the message body be used as  input  to  the
  1581. mailer.
  1582.  
  1583.   ex. Owner JohnD wants to subscribe his class to the
  1584. math102 list.
  1585.       JohnD would start by creating a file using an editor
  1586. like vi,
  1587.       emacs or pico  and enter the subscription request
  1588. for the class.
  1589.  
  1590.      vi class102 <-
  1591.  
  1592.      system math102 begin102 9311023@ cc.wwu.edu & <-
  1593.  
  1594.        #subscribe math102 Ron Jones <-
  1595.  
  1596.      system math102 begin102 9422008@ cc.wwu.edu & <-
  1597.  
  1598.        #subscribe math102 Sherli Hack <-
  1599.  
  1600.      system math102 begin102 9599033@ cc.wwu.edu & <-
  1601.  
  1602.        #subscribe math102 Peter Lakes <-
  1603.  
  1604.      <esc>
  1605.  
  1606.      <shift>: <-
  1607.  
  1608.      :wq <-
  1609.  
  1610.      mail listproc@cc.wwu.edu < class102 <-
  1611.  
  1612. The   results  of  this  is  that  the  three  students  are
  1613. subscribed to the list math102 and each are sent  a  message
  1614. that they have been subscribed to the math102 list.
  1615.  
  1616. In general, a user-request may be any of the recognized user
  1617. requests described
  1618. in Appendix A.
  1619.  
  1620.  
  1621. APPROVE
  1622.  
  1623.   syntax> approve list-name list-password tag
  1624.  
  1625. A  moderated list requires the owner to approve the  posting
  1626. of  a new message when it arrives at the list. A copy of the
  1627. message  is sent to the list's owner requesting approval  --
  1628. proper  instructions for approving or discarding  a  message
  1629. are  included.  This request approves the message identified
  1630. by  the  tag number for posting to the list.  The tag number
  1631. is provided to the list's owner by Listproc and is unique.
  1632.  
  1633.  
  1634. DISCARD
  1635.  
  1636.   syntax> discard list-name list-password tag
  1637.  
  1638. In  contrast  to the approve command request, this  discards
  1639. the  message  identified  by tag.   Messages  that  are  not
  1640. approved or discarded remain in the list's moderated file.
  1641.  
  1642.  
  1643. REPORTS
  1644.  
  1645.   syntax> reports list-name list-password
  1646.  
  1647. The  reports request is used to obtain pertinent reports  to
  1648. the  list;  this will send two mail messages: one  with  the
  1649. current report
  1650.  
  1651.   server/lists/list_alias/.report.list,
  1652.  
  1653. and one with the previously archived ones
  1654.  
  1655.   server/lists/list_alias/.rep.list.acc
  1656.  
  1657. Once the ".rep.list.acc" file is sent, the file is shrunk in
  1658. size,  therefore the owner should make sure that  they  keep
  1659. the copy that is received.  The owner should request reports
  1660. periodically  to reduce the amount of disk  space  the  list
  1661. occupies.
  1662.  
  1663.  
  1664. EDIT
  1665.  
  1666.   syntax> edit list-name list-password file
  1667.  
  1668. The owner can obtain the specified file for editing;
  1669. candidate files are:
  1670.  
  1671.   aliases      - Obtain the list's aliases file.
  1672.  
  1673.   ignored      - Obtain the list's list of unwelcome
  1674. addresses.
  1675.  
  1676.   info         - Obtain the list's information message.
  1677.  
  1678.   subscribers  - Obtain the list's subscribers list.
  1679.  
  1680.   welcome      - Obtain the list's welcoming message.
  1681.  
  1682.   news         - Obtain the list's list of newsgroup
  1683. connections.
  1684.  
  1685.   peers        - Obtain the list's peers.
  1686.  
  1687.  
  1688. PUT
  1689.  
  1690.   syntax> put list-name list-password keyword [args]
  1691.  
  1692. This enables the list's owner to append to the .aliases  and
  1693. .ignored  files,  or replace the .welcome, .info,  .aliases,
  1694. .ignored,  .subscribers, .news, and .peers files,  depending
  1695. on the keyword.  Valid keywords are:
  1696.  
  1697.   alias        - Add a user address alias to the list's and
  1698. system's .aliases
  1699.                  files.  This requires the new address and
  1700. the address used
  1701.                  for subscription as arguments:
  1702.  
  1703.   put <list> <password> alias <new-alias> <address-as-
  1704. subscribed>
  1705.  
  1706.   example.
  1707.  
  1708.      put alpha alpha1 alias johnDoe johnD@cc.wwu.edu
  1709.  
  1710.  
  1711.   ignore       - Add a user address to the list's .ignore
  1712. file only.  The
  1713.                  address has to be provided as argument:
  1714.  
  1715.   example.
  1716.  
  1717.         put alpha alpha1 ignore johnD@ cc.wwu.edu
  1718.         put alpha alpha1 ignore johnDoe
  1719.  
  1720.   welcome      - Append text to the .welcome file message.
  1721.  
  1722.   aliases      - Append aliases to the list .aliases file.
  1723.  
  1724.   ignored      - Append to the list and server .ignored
  1725. files.
  1726.  
  1727.   subscribers   - Add subscribers to the list's .subscribers
  1728. file.
  1729.                    New subscribers are not notified that
  1730. they have
  1731.                    been subscribed.  To have new subscribes
  1732. notified
  1733.                    the systems command must be used.
  1734.  
  1735.   news         - Append to the list's .news file.
  1736.  
  1737.   peers        - Create a new system file.
  1738.  
  1739. For   the   keywords   welcome,  info,   aliases,   ignored,
  1740. subscribers,  news and peers no arguments are  needed.   The
  1741. text  that  is to be appended or placed in the corresponding
  1742. file  starts at the line following the put request and spans
  1743. till  the  end  of  the  mail message. Therefore,  no  other
  1744. requests  can  be made in the same mail message  since  they
  1745. will  be  treated  as  regular text;  signature  lines  also
  1746. signify the end of text, provided they start with "--" in  a
  1747. single line.
  1748.  
  1749. A confirmation is sent to the owner once a put request is
  1750. successfully processed.
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.